home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / attraction.1 < prev    next >
Text File  |  1995-07-25  |  12KB  |  265 lines
  1.  
  2.  
  3.  
  4.      XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))     XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((22222222----mmmmaaaarrrr----99993333))))      XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           attraction - interactions of opposing forces
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           aaaattttttttrrrraaaaccccttttiiiioooonnnn [-display _h_o_s_t:_d_i_s_p_l_a_y._s_c_r_e_e_n] [-foreground
  13.           _c_o_l_o_r] [-background _c_o_l_o_r] [-window] [-root] [-mono]
  14.           [-install] [-visual _v_i_s_u_a_l] [-points _i_n_t] [-threshold _i_n_t]
  15.           [-mode balls | lines | polygons | splines | filled-splines |
  16.           tails ] [-color-mode cycle | random] [-size _i_n_t] [-segments
  17.           _i_n_t] [-delay _u_s_e_c_s] [-color-shift _d_e_g_r_e_e_s] [-radius _i_n_t]
  18.           [-vx _i_n_t] [-vy _i_n_t] [-glow] [-noglow] [-orbit]
  19.  
  20.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.           The _a_t_t_r_a_c_t_i_o_n program has several visually different modes
  22.           of operation, all of which are based on the interactions of
  23.           a set of control points which attract each other up to a
  24.           certain distance, and then begin to repel each other.  The
  25.           attraction/repulsion is proportional to the distance between
  26.           any two particles.
  27.  
  28.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  29.           _a_t_t_r_a_c_t_i_o_n accepts the following options:
  30.  
  31.           ----wwwwiiiinnnnddddoooowwww Draw on a newly-created window.  This is the
  32.                   default.
  33.  
  34.           ----rrrrooooooootttt   Draw on the root window.
  35.  
  36.           ----mmmmoooonnnnoooo   If on a color display, pretend we're on a monochrome
  37.                   display.
  38.  
  39.           ----iiiinnnnssssttttaaaallllllll
  40.                   Install a private colormap for the window.
  41.  
  42.           ----vvvviiiissssuuuuaaaallll _v_i_s_u_a_l
  43.                   Specify which visual to use.  Legal values are the
  44.                   name of a visual class, or the id number (decimal or
  45.                   hex) of a specific visual.
  46.  
  47.           ----ppppooooiiiinnnnttttssss iiiinnnntttteeeeggggeeeerrrr
  48.                   How many control points should be used, or 0 to
  49.                   select the number randomly.  Default 0.  Between 3
  50.                   and 15 works best.
  51.  
  52.           ----tttthhhhrrrreeeesssshhhhoooolllldddd iiiinnnntttteeeeggggeeeerrrr
  53.                   The distance (in pixels) from each particle at which
  54.                   the attractive force becomes repulsive.  Default
  55.                   100.
  56.  
  57.           ----mmmmooooddddeeee bbbbaaaallllllllssss |||| lllliiiinnnneeeessss |||| ppppoooollllyyyyggggoooonnnnssss |||| ttttaaaaiiiillllssss |||| sssspppplllliiiinnnneeeessss |||| ffffiiiilllllllleeeedddd----
  58.                   sssspppplllliiiinnnneeeessss
  59.                   In _b_a_l_l_s mode (the default) the control points are
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 6/30/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))     XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((22222222----mmmmaaaarrrr----99993333))))      XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))
  71.  
  72.  
  73.  
  74.                   drawn as filled circles.  The larger the circle, the
  75.                   more massive the particle.
  76.  
  77.                   In _l_i_n_e_s mode, the control points are connected by
  78.                   straight lines; the effect is something like _q_i_x.
  79.  
  80.                   In _p_o_l_y_g_o_n_s mode, the control points are connected
  81.                   by straight lines, and filled in.  This is most
  82.                   interesting in color.
  83.  
  84.                   In _s_p_l_i_n_e_s mode, a closed spline is interpolated
  85.                   from the control points.
  86.  
  87.                   In _f_i_l_l_e_d-_s_p_l_i_n_e_s mode, the splines are filled in
  88.                   instead of being outlines.  This is most interesting
  89.                   in color.
  90.  
  91.                   In _t_a_i_l_s mode, the path which each particle follows
  92.                   is indicated by a worm-like trail, whose length is
  93.                   controlled by the _s_e_g_m_e_n_t_s parameter.
  94.  
  95.           ----ccccoooolllloooorrrr----mmmmooooddddeeee ccccyyyycccclllleeee |||| rrrraaaannnnddddoooommmm
  96.                   Whether colors should cycle through the spectrum, or
  97.                   be picked randomly.
  98.  
  99.           ----ssssiiiizzzzeeee iiiinnnntttteeeeggggeeeerrrr
  100.                   The size of the balls in pixels, or 0, meaning to
  101.                   select the sizes randomly (the default.)  If this is
  102.                   specified, then all balls will be the same size.
  103.                   This option has an effect in all modes, since the
  104.                   ``size'' of the balls controls their mass.
  105.  
  106.           ----sssseeeeggggmmmmeeeennnnttttssss iiiinnnntttteeeeggggeeeerrrr
  107.                   If in _l_i_n_e_s or _p_o_l_y_g_o_n_s mode, how many sets of line
  108.                   segments or polygons should be drawn. Default 100.
  109.                   This has no effect in _b_a_l_l_s mode.  If _s_e_g_m_e_n_t_s is 0,
  110.                   then no segments will ever be erased (this is only
  111.                   useful in color.)
  112.  
  113.           ----ddddeeeellllaaaayyyy mmmmiiiiccccrrrroooosssseeeeccccoooonnnnddddssss
  114.                   How much of a delay should be introduced between
  115.                   steps of the animation.  Default 10000, or about
  116.                   0.01 seconds.
  117.  
  118.           ----ccccoooolllloooorrrr----sssshhhhiiiifffftttt ddddeeeeggggrrrreeeeeeeessss
  119.                   If on a color display, the color of the line
  120.                   segments or polygons will cycle through the
  121.                   spectrum.  This specifies how far the hue of each
  122.                   segment should be from the next, in degrees on the
  123.                   HSV wheel.  Default 3.  This has no effect in _b_a_l_l_s
  124.                   mode.
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 6/30/95)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))     XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((22222222----mmmmaaaarrrr----99993333))))      XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))
  137.  
  138.  
  139.  
  140.           ----rrrraaaaddddiiiiuuuussss The size in pixels of the circle on which the points
  141.                   are initially positioned.  The default is slightly
  142.                   smaller than the size of the window.
  143.  
  144.           ----gggglllloooowwww   This is consulted only in _b_a_l_l_s mode.  If this is
  145.                   specified, then the saturation of the colors of the
  146.                   points will vary according to their current
  147.                   acceleration.  This has the effect that the balls
  148.                   flare brighter when they are reacting to each other
  149.                   most strongly.
  150.  
  151.                   In _g_l_o_w mode, all of the balls will be drawn the
  152.                   same (random) color, modulo the saturation shifts.
  153.                   In non-glow mode, the balls will each be drawn in a
  154.                   random color that doesn't change.
  155.  
  156.           ----nnnnoooogggglllloooowwww Don't do ``glowing.''  This is the default.
  157.  
  158.           ----vvvvxxxx ppppiiiixxxxeeeellllssss
  159.  
  160.           ----vvvvyyyy ppppiiiixxxxeeeellllssss
  161.                   Initial velocity of the balls.  This has no effect
  162.                   in ----oooorrrrbbbbiiiitttt mode.
  163.  
  164.           ----oooorrrrbbbbiiiitttt  Make the initial force on each ball be tangential to
  165.                   the circle on which they are initially placed, with
  166.                   the right velocity to hold them in orbit about each
  167.                   other.  After a while, roundoff errors will cause
  168.                   the orbit to decay.
  169.  
  170.           ----vvvvmmmmuuuulllltttt ffffllllooooaaaatttt
  171.                   In orbit mode, the initial velocity of the balls is
  172.                   multiplied by this; a number less than 1 will make
  173.                   the balls pull closer together, and a larger number
  174.                   will make them move apart.  The default is 1,
  175.                   meaning stability.
  176.  
  177.      EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  178.           DDDDIIIISSSSPPPPLLLLAAAAYYYY to get the default host and display number.
  179.  
  180.           XXXXEEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  181.                   to get the name of a resource file that overrides
  182.                   the global resources stored in the RESOURCE_MANAGER
  183.                   property.
  184.  
  185.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  186.           XXXX(1), xxxxssssccccrrrreeeeeeeennnnssssaaaavvvveeeerrrr(1)
  187.  
  188.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  189.           Copyright c 1992, 1993 by Jamie Zawinski.  Permission to
  190.           use, copy, modify, distribute, and sell this software and
  191.           its documentation for any purpose is hereby granted without
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 6/30/95)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))     XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((22222222----mmmmaaaarrrr----99993333))))      XXXXSSSSccccrrrreeeeeeeennnnSSSSaaaavvvveeeerrrr((((1111))))
  203.  
  204.  
  205.  
  206.           fee, provided that the above copyright notice appear in all
  207.           copies and that both that copyright notice and this
  208.           permission notice appear in supporting documentation.  No
  209.           representations are made about the suitability of this
  210.           software for any purpose.  It is provided "as is" without
  211.           express or implied warranty.
  212.  
  213.      AAAAUUUUTTTTHHHHOOOORRRR
  214.           Jamie Zawinski <jwz@mcom.com>, 13-aug-92.
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 6/30/95)
  262.  
  263.  
  264.  
  265.